home *** CD-ROM | disk | FTP | other *** search
DRM_ADMIN(1) User Commands DRM_ADMIN(1) NNNNAAAAMMMMEEEE ddddrrrrmmmm____aaaaddddmmmmiiiinnnn - Data Replication Manager Administrative Tool SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS ////eeeettttcccc////nnnnccccssss////ddddrrrrmmmm____aaaaddddmmmmiiiinnnn [ ----vvvveeeerrrrssssiiiioooonnnn ] DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN The ddddrrrrmmmm____aaaaddddmmmmiiiinnnn tool administers servers based on the Data Replication Manager (DRM) such as ggggllllbbbbdddd, the replicated ver- sion of the Global Location Broker (GLB). With ddddrrrrmmmm____aaaaddddmmmmiiiinnnn, you can inspect or modify replica lists, merge databases to force convergence among replicas, stop servers, and delete replicas. The role of ddddrrrrmmmm____aaaaddddmmmmiiiinnnn is to administer the replication of databases, not to change the data they contain. For instance, you can use ddddrrrrmmmm____aaaaddddmmmmiiiinnnn to merge two replicas of the GLB database, but you must use llllbbbb____aaaaddddmmmmiiiinnnn to add a new entry to the database. Also, although ddddrrrrmmmm____aaaaddddmmmmiiiinnnn can stop or delete a GLB replica, you must invoke ggggllllbbbbdddd directly if you want to start or create a replica. Once invoked, ddddrrrrmmmm____aaaaddddmmmmiiiinnnn enters an interactive mode, in which it accepts the commands described below. OOOOPPPPTTTTIIIIOOOONNNNSSSS ----vvvveeeerrrrssssiiiioooonnnn Display the version of NCK that this ddddrrrrmmmm____aaaaddddmmmmiiiinnnn belongs to, but do not start the tool. CCCCOOOOMMMMMMMMAAAANNNNDDDDSSSS Most ddddrrrrmmmm____aaaaddddmmmmiiiinnnn commands operate on a default object (_d_e_f_a_u_l_t__o_b_j) at a default host (_d_e_f_a_u_l_t__h_o_s_t). Together, _d_e_f_a_u_l_t__o_b_j and _d_e_f_a_u_l_t__h_o_s_t specify a default replica. Defaults are established by the sssseeeetttt command and are remem- bered until changed by another sssseeeetttt. Currently, the only known object is ggggllllbbbb. Some ddddrrrrmmmm____aaaaddddmmmmiiiinnnn commands operate on a host other than the default. We identify this host as _o_t_h_e_r__h_o_s_t. The host name you supply as a _d_e_f_a_u_l_t__h_o_s_t or an _o_t_h_e_r__h_o_s_t takes the form _f_a_m_i_l_y::::_h_o_s_t, where the host can be specified either by its name or by its network address. For example, ddddddddssss::::////////jjjjeeeeeeeevvvveeeessss, ddddddddssss::::####111100001111aaaa....55557777ffff99995555, iiiipppp::::bbbbeeeerrrrttttiiiieeee, and iiiipppp::::####111199992222....5555....5555....5555 are acceptable host names. aaaaddddddddrrrreeeepppp _o_t_h_e_r__h_o_s_t Add _o_t_h_e_r__h_o_s_t to the replica list at _d_e_f_a_u_l_t__h_o_s_t. The replica at _d_e_f_a_u_l_t__h_o_s_t will propagate _o_t_h_e_r__h_o_s_t NCS Administration Last change: 1 DRM_ADMIN(1) User Commands DRM_ADMIN(1) to all other replica lists for _d_e_f_a_u_l_t__o_b_j. cccchhhhrrrreeeepppp ----ffffrrrroooommmm _o_t_h_e_r__h_o_s_t ----ttttoooo _n_e_w__o_t_h_e_r__h_o_s_t Change the network address for _o_t_h_e_r__h_o_s_t in the replica list at _d_e_f_a_u_l_t__h_o_s_t to _n_e_w__o_t_h_e_r__h_o_s_t. The replica at _d_e_f_a_u_l_t__h_o_s_t will propagate this change to all other replica lists for _d_e_f_a_u_l_t__o_b_j. The cccchhhhrrrreeeepppp command will fail if a replica of _d_e_f_a_u_l_t__o_b_j is run- ning at _o_t_h_e_r__h_o_s_t or if _o_t_h_e_r__h_o_s_t is not on the replica list at _d_e_f_a_u_l_t__h_o_s_t. ddddeeeellllrrrreeeepppp _o_t_h_e_r__h_o_s_t Delete the replica of _d_e_f_a_u_l_t__o_b_j at _o_t_h_e_r__h_o_s_t. The ddddeeeellllrrrreeeepppp command tells the replica at _o_t_h_e_r__h_o_s_t 1.To propagate all of the entries in its propagation queue 2.To propagate a delete request to all other replicas, causing _o_t_h_e_r__h_o_s_t to be deleted from all other replica lists for _d_e_f_a_u_l_t__o_b_j 3.To delete its copy of _d_e_f_a_u_l_t__o_b_j 4.To stop running The ddddeeeellllrrrreeeepppp command returns you immediately to the ddddrrrrmmmm____aaaaddddmmmmiiiinnnn prompt, but the actual deletion of the replica can take a long time in configurations that are not stable and intact. You can check whether the daemon for the deleted replica has stopped by listing the processes running on its host. iiiinnnnffffoooo Get status information about the replica for _d_e_f_a_u_l_t__o_b_j at _d_e_f_a_u_l_t__h_o_s_t. llllrrrreeeepppp [ ----dddd ] [ ----cccclllloooocccckkkkssss ] [ ----nnnnaaaa ] List replicas for _d_e_f_a_u_l_t__o_b_j as stored in the replica list at _d_e_f_a_u_l_t__h_o_s_t. The ----dddd option lists deleted as well as existing repli- cas. The ----cccclllloooocccckkkkssss option shows the current time on each host and indicates clock skew among the replicas. The ----nnnnaaaa option lists the network address of each host. mmmmeeeerrrrggggeeee { ----ffffrrrroooommmm | ----ttttoooo } _o_t_h_e_r__h_o_s_t The mmmmeeeerrrrggggeeee command copies entries in the _d_e_f_a_u_l_t__o_b_j database and replica list from one replica to another. It copies an entry if no corresponding entry exists in the destination database or if the corresponding entry NCS Administration Last change: 2 DRM_ADMIN(1) User Commands DRM_ADMIN(1) in the destination database bears an earlier timestamp. A merge does not cause entries to be propagated. The database and replica list at the origination are not changed. The ----ffffrrrroooommmm option copies entries from the _d_e_f_a_u_l_t__o_b_j database and replica list at _o_t_h_e_r__h_o_s_t to the _d_e_f_a_u_l_t__o_b_j database and replica list at _d_e_f_a_u_l_t__h_o_s_t. The ----ttttoooo option copies entries from the database and replica list at _d_e_f_a_u_l_t__h_o_s_t to the database and replica list at _o_t_h_e_r__h_o_s_t. A mmmmeeeerrrrggggeeee ----ffffrrrroooommmm followed by a mmmmeeeerrrrggggeeee ----ttttoooo causes the repli- cas at the two hosts to converge. mmmmeeeerrrrggggeeee____aaaallllllll The mmmmeeeerrrrggggeeee____aaaallllllll command uses _d_e_f_a_u_l_t__h_o_s_t as the hub for a global merge of all replicas for _d_e_f_a_u_l_t__o_b_j. For each host on the replica list at _d_e_f_a_u_l_t__h_o_s_t, a mmmmeeeerrrrggggeeee____aaaallllllll first does a mmmmeeeerrrrggggeeee ----ffffrrrroooommmm, then does a mmmmeeeerrrrggggeeee ---- ttttoooo. All replicas of _d_e_f_a_u_l_t__o_b_j are thereby forced into a consistent state. The mmmmeeeerrrrggggeeee____aaaallllllll operation does not cause any entries to be propagated. You should do a mmmmeeeerrrrggggeeee____aaaallllllll +o When a replica is purged +o When a replica is reset +o When a replica has been incommunicado for two weeks or more +o When a replica (for example, when its database is destroyed by a disk failure) mmmmoooonnnniiiittttoooorrrr [ ----rrrr _n ] This command causes ddddrrrrmmmm____aaaaddddmmmmiiiinnnn to read the clock of each replica of _d_e_f_a_u_l_t__o_b_j every _n minutes and to report any clock skews or non-answering replicas. If you do not specify ----rrrr, the period is 15 minutes. ppppuuuurrrrggggeeeerrrreeeepppp _o_t_h_e_r__h_o_s_t The ppppuuuurrrrggggeeeerrrreeeepppp command purges _o_t_h_e_r__h_o_s_t from the replica list at _d_e_f_a_u_l_t__h_o_s_t. The replica at _d_e_f_a_u_l_t__h_o_s_t then propagates a delete request to the replicas at the hosts remaining on its list, thereby removing _o_t_h_e_r__h_o_s_t from all other replica lists for _d_e_f_a_u_l_t__o_b_j. The delete request is not sent to _o_t_h_e_r__h_o_s_t. NCS Administration Last change: 3 DRM_ADMIN(1) User Commands DRM_ADMIN(1) A ppppuuuurrrrggggeeeerrrreeeepppp can cause data to be lost and should only be used when a replica has We recommend strongly that you do a mmmmeeeerrrrggggeeee____aaaallllllll operation after the ppppuuuurrrrggggeeeerrrreeeepppp to prevent the remaining replicas of the _d_e_f_a_u_l_t__o_b_j database from becoming inconsistent. If the purged replica is still running, it should be rrrreeeesssseeeetttt. We recommend that you use cccchhhhrrrreeeepppp (rather than aaaaddddddddrrrreeeepppp and ppppuuuurrrrggggeeeerrrreeeepppp) to change entries on the replica list. qqqquuuuiiiitttt Quit the ddddrrrrmmmm____aaaaddddmmmmiiiinnnn session. rrrreeeesssseeeetttt _o_t_h_e_r__h_o_s_t Reset the replica of _d_e_f_a_u_l_t__o_b_j at _o_t_h_e_r__h_o_s_t. The rrrreeeesssseeeetttt command tells the replica at _o_t_h_e_r__h_o_s_t to delete its copy of _d_e_f_a_u_l_t__o_b_j and to stop running. It does not cause _o_t_h_e_r__h_o_s_t to be deleted from any other replica lists. This command can cause data to be lost unless a successful mmmmeeeerrrrggggeeee____aaaallllllll is done first. sssseeeetttt [ ----oooo _o_b_j__n_a_m_e ] ----hhhh _h_o_s_t__n_a_m_e Set the default object and host. All subsequent com- mands will operate on _o_b_j__n_a_m_e. Subsequent commands that do not specify a host will be sent to _h_o_s_t__n_a_m_e. If you do not specify the ----oooo option, ddddrrrrmmmm____aaaaddddmmmmiiiinnnn keeps the current _d_e_f_a_u_l_t__o_b_j. If you use sssseeeetttt with the ----oooo option, ddddrrrrmmmm____aaaaddddmmmmiiiinnnn checks the clocks at all hosts with replicas of the specified object. ssssttttoooopppp Stop the server for _d_e_f_a_u_l_t__o_b_j that is running at _d_e_f_a_u_l_t__h_o_s_t. EEEEXXXXAAAAMMMMPPPPLLLLEEEE The following example starts ddddrrrrmmmm____aaaaddddmmmmiiiinnnn, sets the default object to ggggllllbbbb, and sets the default host to ////////mmmmaaaarrrrssss: _$$$$ ////eeeettttcccc////nnnnccccssss////ddddrrrrmmmm____aaaaddddmmmmiiiinnnn _dddd_rrrr_mmmm______aaaa_dddd_mmmm_iiii_nnnn_:::: sssseeeetttt ----oooo ggggllllbbbb ----hhhh ddddddddssss::::////////mmmmaaaarrrrssss _DDDD_eeee_ffff_aaaa_uuuu_llll_tttt _oooo_bbbb_jjjj_eeee_cccc_tttt_:::: _gggg_llll_bbbb _dddd_eeee_ffff_aaaa_uuuu_llll_tttt _hhhh_oooo_ssss_tttt_:::: _dddd_dddd_ssss_::::_////_////_mmmm_aaaa_rrrr_ssss _ssss_tttt_aaaa_tttt_eeee_:::: _iiii_nnnn _ssss_eeee_rrrr_vvvv_iiii_cccc_eeee _CCCC_hhhh_eeee_cccc_kkkk_iiii_nnnn_gggg _cccc_llll_oooo_cccc_kkkk_ssss _oooo_ffff _gggg_llll_bbbb _rrrr_eeee_pppp_llll_iiii_cccc_aaaa_ssss _dddd_dddd_ssss_::::_////_////_mmmm_aaaa_rrrr_ssss _1111_9999_8888_7777_////_0000_4444_////_0000_9999_...._1111_7777_::::_0000_9999 _dddd_dddd_ssss_::::_////_////_pppp_llll_uuuu_tttt_oooo _1111_9999_8888_7777_////_0000_4444_////_0000_9999_...._1111_7777_::::_0000_9999 _dddd_dddd_ssss_::::_////_////_mmmm_eeee_rrrr_cccc_uuuu_rrrr_yyyy _1111_9999_8888_7777_////_0000_4444_////_0000_9999_...._1111_7777_::::_0000_7777 SSSSEEEEEEEE AAAALLLLSSSSOOOO _M_a_n_a_g_i_n_g _N_C_S _S_o_f_t_w_a_r_e NCS Administration Last change: 4 
